package com.chnnelsoft.controller;

import com.chnnelsoft.pojo.User;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * 1.我们可以通过Swagger给一些比较难理解的属性或者接口，增阿基注释信息
 * 2.接口文档实时更新
 * 3.可以在线测试
 * 【注意点】
 * 在正式发布的时候关闭swagger！！
 */

@Api(tags = "swagger测试")
@RestController
public class HelloController {

    @GetMapping(value = {"/hello"})
    public String hello(){
        return "hello";
    }
        // 接口中返回值中存在实体类，他就会被扫描到swagger中
    @PostMapping(value = {"/user"})
    public User user(){
        return new User();
    }

    //operation接口，不是放在类上的
    @ApiOperation("Hello控制类")
    @GetMapping(value = {"/hello2"})
    public String hello(@ApiParam("用户名") String username){
        return "hello"+username;
    }


    @ApiOperation("Post控制类")
    @PostMapping(value = {"/post"})
    public User hello(@ApiParam("用户名") User user){
        return user;
    }

}
